home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / miser_submit.z / miser_submit
Text File  |  1998-10-20  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4. mmmmiiiisssseeeerrrr____ssssuuuubbbbmmmmiiiitttt((((1111))))                                                mmmmiiiisssseeeerrrr____ssssuuuubbbbmmmmiiiitttt((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      miser_submit - submit a job to a miser queue
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      mmmmiiiisssseeeerrrr____ssssuuuubbbbmmmmiiiitttt -q qqqqnnnnaaaammmmeeee  -f ffffiiiilllleeee command
  13.  
  14.      mmmmiiiisssseeeerrrr____ssssuuuubbbbmmmmiiiitttt -q qqqqnnnnaaaammmmeeee  -o c=CCCCPPPPUUUUssss,m=mmmmeeeemmmmoooorrrryyyy,t=ttttiiiimmmmeeee command
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      The _m_i_s_e_r__s_u_b_m_i_t command is used to submit a job (the command) to a
  18.      _m_i_s_e_r(_1) queue.  A job is an application that will be scheduled by miser.
  19.      Any application that does not change its session ID or change its process
  20.      group ID can be submitted to a miser queue. For an application to be
  21.      properly submitted to a _m_i_s_e_r(_1) queue, it needs to specify its resource
  22.      schedule. A resource schedule is a list of resource specifications,
  23.      called segments, that define the resource requirements of a particular
  24.      job. A resource specification is a tuple of CPUs, memory and wall clock
  25.      time. Currently _m_i_s_e_r(_1) only supports resource schedules consisting of
  26.      one segment. A segment also has additional optional fields that specify
  27.      how the job is to be scheduled.  These are defined in _m_i_s_e_r__s_u_b_m_i_t(_4).
  28.  
  29.      An application is said to be scheduled by _m_i_s_e_r(_1), if it can find a
  30.      block of time/space in the resources managed by the specified queue to
  31.      schedule each segment of the application's resource schedule.  If miser
  32.      can find such a block, then a schedule is returned to the user. The
  33.      schedule is a list of start and end times for each segment of the
  34.      resource schedule. The end times are guaranteed by miser, in other words,
  35.      either the application will have terminated by then or the application
  36.      will be terminated.  Miser's default scheduling policy will do a first
  37.      fit of each segment of the schedule in the specified queue.
  38.  
  39.      The schedule returned by _m_i_s_e_r(_1) reflects the system's guarantee of
  40.      resources; during the time specified by miser, the application will be
  41.      allocated the physical resources requested. However, unless the
  42.      application has requested _S_T_A_T_I_C scheduling (see miser_submit(4)), the
  43.      application will be allowed to run before its designated time if there
  44.      are resources available. The time it runs before it actually runs is a
  45.      bonus and is not counted against the actual time it has been scheduled to
  46.      run.
  47.  
  48.      The format of the schedule returned by _m_i_s_e_r__s_u_b_m_i_t is a table that lists
  49.      the batch ID, segment ID, multiple, priority, exception condition, wall
  50.      clock time, completion date, CPUs allocated and memory allocated for each
  51.      segment. The batch ID is used by _m_i_s_e_r(_1), various miser commands, and
  52.      the kernel to communicate about a specific job.  It is equivalent to the
  53.      process group ID.  The segment ID identifies the current segment in the
  54.      resource schedule list.  The priority is an additional field provided for
  55.      use by scheduling policies. The wall clock time is the product of CPU
  56.      time and the number of CPUs. The completion date is when _m_i_s_e_r(_1) has
  57.      scheduled the segment to terminate. The CPUs allocated and the memory
  58.      allocated list the resources reserved for that segment.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. mmmmiiiisssseeeerrrr____ssssuuuubbbbmmmmiiiitttt((((1111))))                                                mmmmiiiisssseeeerrrr____ssssuuuubbbbmmmmiiiitttt((((1111))))
  71.  
  72.  
  73.  
  74. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  75.      ----qqqq _q_n_a_m_e
  76.           Specifies the queue against which to schedule the application. The
  77.           user must have execute permissions on the queue definition file to
  78.           schedule an application against the resources of a particular queue.
  79.           The queue name must be a valid queue name.
  80.  
  81.       ----oooo cccc====_C_P_U_s,,,,mmmm====_m_e_m,,,,tttt====_t_i_m_e
  82.           Specifies a block of resources from the command line. The CPUs must
  83.           be some integer up to the maximum number of CPUs available to the
  84.           queue being scheduled against. The memory consists of an integer
  85.           followed by a unit of _k for kilobyte, _m for megabyte or _g for
  86.           gigabyte. The memory requested cannot exceed the total memory
  87.           available to the queue. If no unit is specified, the default is
  88.           bytes.  The time can be specified either by an integer followed by a
  89.           unit specifier of _h for hours, _m for minutes or _s for seconds, or by
  90.           a string of the form _h_h:_m_m._s_s. An integer with no units is assumed
  91.           to be seconds.
  92.  
  93.      ----ffff _f_i_l_e
  94.           This file specifies a list of resource segments. Using the file
  95.           allows greater control over the scheduling parameters of a
  96.           particular job.
  97.  
  98. RRRREEEESSSSTTTTRRRRIIIICCCCTTTTIIIIOOOONNNNSSSS
  99.      An application scheduled by _m_i_s_e_r(_1) cannot change its process group or
  100.      session ID. If it tries to, an error is returned.
  101.  
  102.      An application that is scheduled by _m_i_s_e_r(_1) cannot change its priority,
  103.      or bind itself to a particular CPU.
  104.  
  105. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  106.      miser(5), miser(1), miser(4), miser_submit(4), miser_jinfo(1),
  107.      miser_qinfo(1), miser_move(1), miser_reset(1).
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.